ChatWorkでDatadogのアラート通知を受けてみた

セキュリティ製品特集

#Chatwork

#Datadog

#監視サービス

#AWS

suzuki.ryo

2016.07.07

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

はじめに

AWSチームのすずきです。

今回、国産チャットツールとして知られるChatWork、監視SaaSのDatadogが検知したアラートの通知先として設定する機会がありましたので、その内容を紹介させて頂きます。

準備

チャットワークAPIの利用に必要となるAPIトークンの発行と、通知先（room_id）の確認を行います。

APIトークン発行

参考リンク

チャットワークAPI ドキュメント（認証方法）

チャットワークの「動作設定」画面に「API発行」が表示されない場合、APIトークンの発行を管理者に依頼してください。

APIテスト環境

OS

Amazon Linux

APIキーの動作テストは、AmazonLinux標準の「curl」を利用しました。

追加パッケージ

JSONの視認性を向上、フィルタリングの実現のため、AmazonLinux標準リポジトリより「jq」をインストールしました。

sudo yum install  jq -y

API実行

APIトークンの動作確認を兼ね、参加チャットの一覧取得するAPIを実行します。
ChatWork APIドキュメント（エンドポイント: /rooms）

TOKEN="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
curl -X GET -H "X-ChatWorkToken: ${TOKEN}" "https://api.chatwork.com/v1/rooms" | head -n 3

room_id確認

チャット通知先として利用する「room_id」を確認します。
チャットワークのURL、GETパラメータとして表示される「rid」は「room_id」は異なりますのでご注意ください。

グループチャット一覧確認

TOKEN="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

curl -X GET -H "X-ChatWorkToken: ${TOKEN}" "https://api.chatwork.com/v1/rooms" | jq '.[]|select(.type == "group") '

チャット名指定

TOKEN="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
curl -X GET -H "X-ChatWorkToken: ${TOKEN}" "https://api.chatwork.com/v1/rooms" | jq '.[]|select(.name == "テスト") '

実行例

{
  "room_id": 0000000,
  "name": "テスト",
  "type": "group",
  "role": "member",
  "sticky": false,
  "unread_num": 2,
  "mention_num": 0,
  "mytask_num": 0,
  "message_num": 2,
  "file_num": 0,
  "task_num": 0,
  "icon_path": "https://tky-chat-work-appdata.s3.amazonaws.com/icon/ico_group.png",
  "last_update_time": 0000000
}